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define IXDOM_H 

declared at: ixdom.h TBD 
struct DNode 

declared at: ixdom,h The DNode struct is the primary datatype for the entire Document Object Model. It 
represents a single node in the document tree. DNode provides a flat interface to manipulate any type of 
node, however, in certain cases some of the 'dom_...' flmctions can not be used. For example, nodes of 
TEXT NODE type may not have children, and adding children to such nodes is an error. Each node has a 
node-name and may have a node-value. DNode-s of ELEMENT NODE type can have also attributes. The 



node-type f -:; : ■> . ^J*;-" - -s-; 


node-name ^ 


n<^-value 




ELEMENT NODE 


tagName 


NULL 


DOMNamedNodeMap 


ATTRIBUTE NODE 


name of attribute 


value of 
attribute 


NULL 


TEXT NODE 


#text 


content of 
the text 
node 


NULL 


CDATA SECTION NODE 


#cdata-section 


content of 
the 

pri ATA 

Section 


NULL 


ENTITY REFERENCE NODE 


name of entity 
referenced 


NULL 


NULL 


ENTITY NODE 


entity name 


NULL 


NULL 


PROCESSDsfG INSTRUCTION NODE! 


target 


entire 
content 
excluding 
the target 


NULL 




COMMENT NODE 


#comment 


content of 
the 

comment 


NULL 


DOCUMENT NODE 


#document 


NULL 


NULL 


DOCUMENT TYPE NODE | 


document type name 


NULL 


NULL 


DOCUMENT FRAGMENT NODE 1 


#document-fragment; 


NULL 


NULL 


NOTATION NODE | 


notation name | 


NULL 1 


NULL 



The following table lists the functions that can be applied for certain node-types. Note: the first parameter 
of these functions is alwa ys a pointer to a node to operate on. 



Inodiiype 



domgetNodeName 



dom getNodeValue 



dom setNodeValue 



dom getNodeType 



dom getParentNode 



dom getChildNodes 



dom getFirstChild 



1 of 12 



3/9/04 3:10 PM 



ixdom_hd. 



.html 



http://www.innoxmlp.com/doc/ixdom_hd.html 



Any type 


dom getPreviousSibling 
dom getNextSibling 
dom getOwnerDocument 


dom insertBefore 
dom replaceChild 
dom removeChild 
dom appendChild 
dom hasChildNodes 
dom cloneNode 


ELEMENT NODE 


dom getTagName 
dom getAttributes 
dom getAttribute 
dom setAttribute 

H om rf»m r^vp A ttn Hi i tf* 

dom getAttributeNode 




dom setAttributeNode 
dom removeAttributeNode 


dom normalize 

dom getElementsBvTagName 


ATTRIBUTE NODE 


dom getAttrName 
dom getAttrValue 
dom setAttrValue 




dom attrlsSpecified 


TEXT NODE 


uum spill ical 

dom getCharacterData 

uum Kcllyalal^wUKin 

dom substringData 




dom appendData 

dom insertData dom deleteData 


dom replaceData 


CDATA SECTION NODE 


dom getCharacterData 

UUlll gClX^ald.I.vCllgUl 

dom substringData 
dom appendData 




dom insertData dom deleteData 


dom replaceData 


ENTITY REFERENCE NODE 


— 


ENTITY NODE 


dom getPublicId 




dom getSystemId 


PROCESSING INSTRUCTION NODE 


dom getPiTarget 




dom getPiDatadom setPiData 


COMMENT NODE 


dom getCharacterData 

UUlll gC/li^alclJL/Cll^Ul 

dom substringData 
dom appendData 




dom insertData dom deleteData 


dom replaceData 




dom setlmplementation 
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DOCUMENT NODE 


dom getlmplementation 

Hntn O'PtT^nptvnp 

Ll villi f£^^lU\J\/iyiJ^ 

Hnm PPtT)nnirnpntT^lpmpTit 


dom createElement 

Hnm f'rPiifpT^npiiTTiP'ntPraoTnprit 


Hnm OTpatpTpvtNndp 




dom createComment 

Hnm f^fPfifpr^T^ A T A ^ppfinn 


dom createProcessinglnstruction 


dom createAttribute 

dom createEntitvReference 


dom getElementsByTagName 


DOCUMENT TYPE NODE 


dom getDoctvpeName 
dom getEntities 
dom getNotations 




dom getPublicId 
dom getSvstemId 


DOCUMENT FRAGMENT NODE 




NOTATION NODE 


dom getPublicId 




dom getSvstemId 



Struct DNodeList 



declared at: ixdom.h DNodeList provides an ordered collection of nodes. The items in the DNodeList are 
accessible via an integral index, starting from 0, using dom getListltem O. dom getListLength O returns the 
number of nodes in the DNodeList object. See also: dom getChildNodes O, 
dom getElementsBvTagName O. 

struct DNamedNodeMap 

declared at: ixdom.h DNamedNodeMap represents a collections of nodes that can be accessed by name. 
Note that DNamedNodeMap is not maintained in any particular order. DNode-s contained in an 
DNamedNodeMap object may also be accessed by an ordinal index, but this is simply to allow convenient 
enumeration of the contents of a DNamedNodeMap . See also: dom getAttributes O. dom getEntities O, 
dom_getNotation() . 

type DImplementation 

declared at: ixdom.h A void pointer that can be attached to a document node. The C implementation does 
not use this value. 

struct DString 

declared at: ixdom.h This string type is exclusively used by the DOM (C) module for internal 
representation, and to provide return values. These strings are owned by the nodes, hence applications must 
not free them. 
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length The number of XmlChar -s that precede the terminating 0 character. Note: the terminating zero is 
also an XmlChar . with zero value. 

buf The memory buffer of the string. The size of the allocated memory for a DString object is 

calculated at creation time, to give enough room for the entire string, plus for the terminating zero. 

Struct DMonitorData 

declared at: ixdom.h DMonitorData gives the context, when a cretain event occured during building the 
tree. This type of object is passed to a monitoring callback- function. Typically it can be used for error 
reporting. See also dom build O and DMonitor . 
cHent data The same *cliet_data* pointer that was given to dom build O. 

ptoken This is the current token of the low-level XML parser. See also IxpCBData , ixpParse O. 

sfr The current string that belongs to the current 'ptoken*. This may be the context of the error, or 

the name of an element, etc. 

slen The length of the 'str'. 

document The document node that is beeing to build. 

parent The parent node of the current node that is beeing to build. 

function type DMonitor 

declared at: ixdom.h If the application gives a monitor (a call-back function) to the dom build O function, 
then the monitor will be called-back if an error occures during the parsing. The monitor's argument 
(DMonitorData) provides the context of the error. Additionally to errors, other low-level events may be 
reported as well. See also dom build O. 

function type DErrorHandler 

declared at: ixdom.h An error handler function can be associated to an existing DOM tree. If an error 
occures during the tree manipulation, the function is called. In contrast to C+-i- exception handling, the 
handler can safely return, the tree remains in a consistent state. See also dom build O and 
dom setErrorHandler O. 

function type DVisitor 

declared at: ixdom.h The application should implement this type of function in order to traverse the tree. 
The dom traverseTree O function takes a DVisitor function, and calls-back for each node during walking 
on the tree. 

function dom_createDocument 

declared at: ixdom.h It creates and retums a new DOM tree (document node) that can be populated by the 
application. The application owns the newly created tree, so it is resonsible to release it with 
dom destrovDocument O. 

function dom_destroyDocument 

declared at: ixdom.h The application should call this function to release the entire docimient tree. 
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function dom_setImplementation 

declareci at: ixdom.h Assign a DImplementation to a DOM tree. This is a helper function for the C++ 
implementation, the C module does not use it for any purpose. 

function dom_getIniplementation 

declared at: ixdom.h Retrieve the DImplementation that was assigned by dom sethnplementation . 
function dom_getDoctype 

declared at: ixdom.h Retums the DocumentType node that is associated to the tree, 
function dom_getDocunientElement 
declared at: ixdom.h Retums the root element of the document tree, 
function domcreateElement 

declared at: ixdom.h Creates and retums an Element node, with the specified name. 

function domcreateDocumentFragment 

declared at: ixdom.h Creates an empty DocumentFragment node. 

function dom_createTextNode 

declared at: ixdom.h Creates a Text node, given the specified string, 
function doni_createComment 

declared at: ixdom.h Creates a Comment node given the specified string, 
function domcreateCDATASection 

declared at: ixdom.h Creates a CDATASection node whose value is the specified string, 
function dom_createProcessingInstruction 

declared at: ixdom.h Creates a Processinglnstruction node given the specified target and data strings. 

function dom_createAttribute 

declared at: ixdom.h Creates an Attr node of the given name. 

function dom_createEntityReference 

declared at: ixdom.h Creates an EntityReference node given the specified name. 
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function dom_getElementsByTagName 

declared at: ixdom.h Returns a DNodeList of all the Elements node with a given tag name in the order in 
which they would be encountered in a preorder traversal of the document tree. 

function domgetNodeName 

declared at: ixdom.h Retums the name of the node, 
function domgetNodeValue 
declared at: ixdom.h Retimis the value of the node, 
function dom_setNodeValue 

declared at: ixdom.h Sets the value of the node. It is an error 

(DOM NO MODIFICATION ALLOWED ERR) to attempt to modify a readonly value, examlpe "#text". 

function dom_getNodeType 

declared at: ixdom.h Retums the type of the node. 

function domgetParentNode 

declared at: ixdom.h Retums the parent of this node. All nodes, except Document, DocumentFragment, and 
Attr may have a parent. However, if a node has just been created and not yet added to the tree, or if it has 
been removed from the tree, then the function retums NULL. 

function dom_getChildNodes 

declared at: ixdom.h Retums a DNodeList that contains all children of this node. If there are no children, 
then the DNodeList does not contain nodes. The content of the retumed DNodeList is "live" in the sense 
that, for instance, changes to the children of the node object that it was created from are immediately 
reflected in the nodes retumed by the NodeList accessors; it is not a static snapshot of the content of the 
node. This is tme for every DNodeList, including the ones retumed by the dom getElementsBvTagName 
function. 

function dom_getFirstChild 

declared at: ixdom.h Retums the first child of this node. If there is no such node, the function retums 
NULL. 

function dom_getLastChild 

declared at: ixdom.h Retums the last child of this node. If there is no such node, the function retums NULL, 
function dom_getPreviousSibling 
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declared at: ixdom.h Returns the node immediately preceding this node. If there is no such node, the 
function returns NULL. 

function dom getNextSibling 

declared ati ixdom.h Retums the node immediately following this node. If there is no such node, the 
functions retums NULL. 

function dom_getAttributes 

declared at: ixdom.h Retums a DNamedNodeMap containing the attributes of this node (if it is an Element) 
or NULL otherwise. 

function dom getOwnerDocument 

declared at: ixdom.h Retums the Document node associated with this node. This is also the DDocument 
node used to create new nodes. When this node is a Document node, then it retums NULL. 

function dom_insertBefore 

declared at: ixdom.h dom insertBefore (this.newChild,refChild) inserts the node newChild before the 
existing child node refChild. If refChild is NULL, then it inserts newChild at the end of the list of children. 
If newChild is a DocumentFragment node, then all of its children are inserted, in the same order, before 
refChild. If the newChild is already in the tree, it is first removed. The function retums the node being 
inserted. The following errors may occur: DOM HIERARCHY REQUEST ERR . 
DOM WRONG DOCUMENT ERR . DOM NO MODIFICATION ALLOWED ERR . 
DOM NOT FOUND ERR . 

function dom_replaceChild 

declared at: ixdom.h dom replaceChild (this.newChild.oldChild) replaces the child node oldChild with 
newChild in the list of children, and retums the oldChild node. If the newChild is ab-eady in the tree, it is 
first removed. The following errors may occur: DOM HIERARCHY REOUEST ERR . 
DOM WRONG DOCUMENT ERR. DOM NO MODIFICATION ALLOWED ERR . 
DOM NOT FOUND ERR . 

function dom removeChild 

declared atr ixdom.h Removes the specified child node from the list of children, and retums it. The 
following errors may occur: DOM NO MODIFICATION ALLOWED ERR. 
DOM NOT FOUND ERR . 

function dom_appendChiId 

declared at: ixdom.h Adds the specified new child to the end of the list of children of this node. If the new 
child is already in the tree, it is first removed. The fimction retums the node added. The following errors 
may occur: DOM HIERARCHY REOUEST ERR . DOM WRONG DOCUMENT ERR . 
DOM NO MODIFICATION ALLOWED ERR. 
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function dom^hasChildNodes 

declared at: ixdom.h Returns TRUE, if the node has children, FALSE if not. 
function dom_cloneNode 

declared at: ixdom.h Returns a duplicate of this node. The duplicate node has no parent (dom_parentNode() 
returns NULL). Cloning an Element copies all attributes and their values, but this method does not copy 
any text it contains unless it is a deep clone, since the text is contained in a child DOMText node. Cloning 
any other type of node simply retums a copy of this node. 



function dom_getListItem 

declared at: ixdom.h dom getListltem (listjdx) retums the idx-th item in the collection. If idx is greater than 
or equal to the number of nodes in the list, then the function retums NULL. 



function dom_getListLength 

declared at: ixdom.h Retums the number of nodes in the list. 



function dom_getNamedItem 

declared at: ixdom.h dom getNamedItem (nodemap,name) retums a DNode object with the specified 'name', 
or NULL if the specified name did not identify any node in the map. 

function dom setNamedltem 

declared at dxdom.h Adds a DNode object to the map, using its name. Nodes of certain types have Tix' 
name e.g. "#text", hence they can not be stored as the names would clash. 

function dom removeNamedltem 

declared at: ixdom.h dom removeNamedItem (nodemap.name) removes the node specified by 'name' from 
the map, and retums it. If the specified name did not identify any node in the map, then it retums NULL. 

function dom_getMapItem 

declared at: ixdom.h dom getMapItem fnodemapjdx) retums the idxth item in the map. If index is greater 
than or equal to the number of nodes in the map, then the function retums NULL. 

function dom_getMapLength 

declared at: ixdom.h Retums the number of nodes in the map. 
function dom_getCharacterData 

declared at:ixdom.h Retums the character data of the node. 



function dom getDataLength 



8 of 12 



3/9/04 3:10 PM 



ixdom_hd.html 



http://www.innoxnilp.com/doc/ixdom_hd.html 



declared at: ixdom.h Returns the number of character units that are available through 

dom getCharacterPata O and the dom substringPata O function below. This may have the value zero, i.e., 

node may be empty. Note: the character unit is defined by XmlChar . 

function dom substringData 

declared at: ixdom.h dom substringData (this,offset,count) returns the 'count* character substring of the 
node's character data, starting at 'offset'. If the sum of 'offset' and 'count' exceeds the length, then all 
characters to the end of the data are returned. The following error may occur: DOM INDEX SIZE ERR . 

function dom_appendData 

declared at: ixdom.h Appends the specified string to the end of the character data of the node. Upon 
success, dom_getDataO provides access to the concatenation of data and the string specified. 

function dom insertData 

declared at: ixdom.h dom insertData (this.offset,str) inserts 'str' at 'offset', 
function domdeleteData 

declared at: ixdom.h dom deleteData (this.offset,count) removes 'count' characters, starting at 'offset'. If the 
sum of 'offset' and 'count' exceeds length of the character data of the node, then all characters fi*om 'offset' 
to the end of the data are deleted. 

function dom_replaceData 

declared at: ixdom.h dom replaceData (this,offset,count,str) replaces 'count' characters starting at 'offset' by 
str. If the sum of 'offset' and 'coimt' exceeds length, then all characters to the end of the data are replaced. 

function dom getAttrName 

declared at: ixdom.h Retums the name of the attribute. 

function dom_getAttrValue 

declared at: ixdom.h Retums the value of the attribute. 

function dom_setAttrVaIue 

declared at: ixdom.h Sets the value of the attribute. 

function dom_attrIsSpecified 

declared at: ixdom.h Retums TRUE, if this attribute was explicitly given a value in the original XML 
document, otherwise it retums FALSE . 

function dom_getTagName 
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declared at: ixdom.h Returns the name of the element node (tagName). 
function dom_getAttribute 

declared at: ixdom.h Retrieves an attribute by its name, and returns the corresponding attribute value. If 
there is no attribute v^ith the specified name, then it returns NULL. 

function dom_setAttribute 

declared at: ixdom.h dom set Attribute (this,name, value) adds a new attribute with 'name', which has the 
specified value. If an attribute with that name is akeady present in the element, its value is changed to be 
that of the value parameter. This value is a simple string, it is not parsed as it is being set. So any markup 
(such as syntax to be recognized as an entity reference) is treated as Uteral text, and needs to be 
appropriately escaped by the application when it is written out. Note: dom printTree Q makes the proper 
escaping. 

function dom removeAttribute 

declared at: ixdom.h Removes an attribute by the specified name, 
function dom getAttributeNode 

declared at: ixdom.h Returns a DOMAttribute node by the specified name, or NULL if there is no such 
attribute. 

function dom setAttributeNode 

declared at: ixdom.h Adds a new attribute. If an attribute with that name is akeady present in the element, it 

is replaced by the new one. If the specified attribute replaces an existing attribute with the same name, then 

the old Attr node is returned, otherwise NULL is retumed. Note: The DOM user must explicitly clone Attr 

nodes to re-use them in other elements. The following errors may occur: 

DOM WRONG DOCUMENT ERR , DOM NO MODIFICATION ALLOWED ERR , 

DOM INUSE ATTRIBUTE ERR . 

function dom removeAttributeNode 

declared at: ixdom.h Removes and retums the specified DOMAttr node. The function retums NULL, if the 
specified attribute node does not belong this element node. The following error may occur: 
DOM NOT FOUND ERR . 

function dom_normalize 

declared at: ixdom.h Puts all Text nodes in the fiill depth of the sub-tree underneath this Element into a 
"normal" form where only markup (e.g., tags, comments, processing instructions, CD ATA sections, and 
entity references) separates Text nodes, i.e., there are no adjacent Text nodes. This can be used to ensure 
that the DOM view of a document is the same as if it were saved and re-loaded, and is usefiil when 
operations (such as XPointer lookups) that depend on a particular document tree structure are to be used. 
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function dom_splitText 

declared at nxdom.h Breaks this Text node into two Text nodes at the specified offset. The character data of 
this node is sphtted into two strings. The first part (up to the offset point) remains in this node, whereas the 
second part (from the offset point) is moved into the new Text node. The new node immediately inserted as 
the next sibling of this node. The function retums the new node. 

function dom_getDoctypeName 

declared at: ixdom.h Retums the name of the document type; i.e., the name that immediately folios the 
DOCTYPE keyword in the textual XML document. 

function dom_get£ntities 

declared at: ixdom.h Retums a DNamedNodeMap node, which contains the collection of Entity nodes, 
defined for the document. Note: the XML parser expands the internal entities, thus they do not appear in 
the returned map. 

function domgetNotations 

declared at: ixdom.h Retums a DNamedNodeMap node, which contains the collection of Notation nodes, 
defined for the docimient. 

function dom getPublicId 

declared ati ixdom.h Retums the public identifier of the node, if it has one. 
function dom_getSystemId 

declared at: ixdom.h Retums the system identifier of the node, if it has one. 
function dom getNotationName 

declared at: ixdom.h Retums the name of the notation that is associated to this entity, 
function dom_getPiTarget 

declared at: ixdom.h Retums the target of this processing instruction. E.g.: <target data part?> 
function dom_getPiData 

declared at: ixdom.h Retums the data part of this processing instruction. E.g.: <target data part?> 
function dom_setPiData 

declared at: ixdom.h Sets the data part of the processing instruction, 
function dom_printTree 
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declared at: ixdom.h dom printTree O serializes a full or sub-tree that is given as the first parameter, and 
prints it out to the specified output stream (IxpStream ). The output character encoding is the same as the 
encoding of the tree. 

function dom_traverseTree 

declared at: ixdom.h The function traverses the tree/subtree denoted by the first parameter (tree). While 
traversing, the Visit' function (second parameter) is called for each node. The third parameter indicates, 
when to call the Visit' function. If it has the value of VISIT WHEN ENTER, then it calls Visit', when the 
node appears at the first time. If it has the VISIT WHEN LEAVE , then it calls only after that its children 
have been visited. If it has the VISIT ENTER AND LEAVE value, then it calls both times. The function 
retums FALSE , if the 'visit' function has aborted the traversing, otherwise TRUE . 

function dombuild 

declared at: ixdom.h dom build O creates a new DOM tree (document node) and populates the tree, from 
the XML document that is given by the IxpParams argument. If a monitor (DMonitor) is provided by the 
application, then it will be called-back for each error and other low-level events, which were specified by 
'event_types' parameter. If a ' client data ' is also provided, then it will be passed to the monitor function. 
The ' cUent data ' (IxpClientData) may point to an application's data structure, to account the occured errors. 
In case of fatal error the monitor is called, then dom build O retums a NULL pointer. 

function domsetErrorHandler 

declared at: ixdom.h This function attaches an error-handler ( DErrorHandler ) to an existsing tree (document 
node). This handler will be called whenever an error occurs during the tree manipulation. The ' client data * 
parameter (IxpClientData) will be passed to the handler function. 
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